home *** CD-ROM | disk | FTP | other *** search
/ The Atari Compendium / The Atari Compendium (Toad Computers) (1994).iso / files / umich / tex / tex29 / sttexsrc.zoo / README
Encoding:
Text File  |  1989-10-27  |  4.1 KB  |  109 lines
  1. This is the CommonTeX V2.9 dist, with mods for the atarist.
  2. Now includes undump and thus the ability to make pre-loaded
  3. latex and tex.
  4.  
  5.     - To make the atari version
  6.         cd src
  7.         cp tex.h.st tex.h
  8.         adjust paths (if you want to) in file.h
  9.          TEXFONTS
  10.          TEXINPUTS
  11.          TEXFORMATS
  12.             adjust sizes in tex.h
  13.           by default sizes in tex.h are set up for a 1M St.
  14.           see tex.h for examples of two other configurations
  15.           (called BIG and BIGG), and see Knuths TeX:The Program
  16.               (v2 in the series i believe) for the meaning of the
  17.            various params.
  18.           Please note: if you adjust tex.h, then you need to
  19.            re-compile both initex and virtex, and depending on
  20.            the situation, re-build the .fmt files with initex
  21.            before virtex can use them.
  22.  
  23.         - to make initex/statex (initex with statistics)
  24.             cd src/INIT
  25.             edit Makefile to set CROSSDIR (home of
  26.             your Gnu Cross compiler stuff), adjust
  27.             CFLAGS and hit make.
  28.         - to make virtex
  29.             cd src/VIR
  30.             edit Makefile to set CROSSDIR (home of
  31.             your Gnu Cross compiler stuff), adjust
  32.             CFLAGS and hit make.
  33.         - to undump a preloaded version of LaTeX or TeX
  34.             undump LaTeX virtex.ttp &lplain
  35.              .......
  36.             * ^\ <== hit the quit character here. for
  37.                  the Gnu C Library it is Control-\
  38.                  (which means hold down the control key and
  39.                   type the character '\' simultaneously).
  40.           This will undump a virtex pre-loaded with lplain.fmt,
  41.           called LaTeX.
  42.           Please NOTE: the second argument to `undump' must be
  43.           the *FULL PATHNAME TO VIRTEX.TTP INCLUDING THE EXTENTION*.
  44.  
  45.     - To make the unix version
  46.         cd src
  47.         cp tex.h.unix tex.h
  48.         adjust (if you want to) in file.h
  49.          TEXFONTS
  50.          TEXINPUTS
  51.          TEXFORMATS
  52.         - to make initex/statex
  53.           choose the size you want (see tex.h)
  54.           cd to either src/INIT or src/BIG/INIT or src/BIGG/INIT or
  55.                    src/BIGGG
  56.           hit make
  57.         - same goes for virtex
  58.             - if you want to undump a preloaded tex/latex
  59.          > virtex \&lplain
  60.            * ^\ (hit the quit char [normally ctrl-\]) at the '*'
  61.                 prompt to make it dump core)
  62.          > undump latex virtex core
  63.           similarly for tex
  64.          > virtex \&plain
  65.            * ^\
  66.          > undump tex virtex core
  67.  
  68. Gulam users can put the following in gulam.g:
  69.  
  70. (f:\ is the path i use, you may specify any path. It is only necessary
  71. to set the following if your default settings in file.h are not
  72. satisfactory, the environment settings override the default settings
  73. at runtime. Note that the paths are ';' seperated so they have to
  74. be specified within quotes [''] otherwise gulam will consider the ';' as
  75. a command seperator).
  76.     setenv TEXFORMATS '.;f:\macros'
  77.     setenv TEXINPUTS '.;f:\macros'
  78.     setenv TEXFONTS '.;f:\tfm'
  79.  
  80. undump:
  81.     usage: undump NEWFILE OLDFILE [args to OLDFILE]
  82. undump runs OLDFILE (the full pathname including the extension for oldfile
  83. must be specified) with the optionally specified args. Whenever OLDFILE
  84. exits back to undump, it will undump its memory image into NEWFILE.
  85. The point at which control should return to undump is determined
  86. by the application OLDFILE. Usually it is at a prompt (like in virtex).
  87. There are many ways to exit, quit (Control-\) being what is usally used.
  88. Please NOTE: the QUIT mechanism is only available in the Gnu C Library.
  89. If for instance you used MWC to make virtex, hitting quit will probably
  90. do you no good. If you exit virtex via Control-C and `x', the undumped
  91. latex that you will obtain will be pretty useless. In short use superior
  92. compilers and tools like Gnu CC and the Gnu C library (and share
  93. your code!).
  94.  
  95. WARNING: it has been reported that an undumped binary, undunp'ed say
  96. on my machine, may not work on your machine. i don't know the reason
  97. for this, and many people have run my undumped binaries on their machines
  98. without any problems. if you encounter this situation, i'll be very interested
  99. in hearing about it (and full details of your setup). all you have to do
  100. in case of this situation is to use undump.ttp to undump a preloaded
  101. LaTex/TeX yourself. i have'nt had any complaint of the resulting undumped
  102. binary not running.
  103.  
  104.                         enjoy,
  105. --
  106. bang:   {any internet host}!dsrgsun.ces.CWRU.edu!bammi    jwahar r. bammi
  107. domain: bammi@dsrgsun.ces.CWRU.edu
  108. GEnie:    J.Bammi
  109.